Ambientes e softwares utilizados na aula: Google Antigravity IDE, Gemini CLI, Python, Node.js, biblioteca ifcopenshell, Google Apps Script com Google Planilhas.

⚙️ O ambiente de referência é sempre Windows.

---

Como instalar cada um — direto ao ponto e o porquê de cada passo

1. Python

• Download: python.org/downloads → versão 3.10 ou superior
• Por quê: linguagem base para automações, scripts e uso de bibliotecas como ifcopenshell
• Durante a instalação, marque ✅ "Add Python to PATH" — isso permite rodar python direto no terminal

2. Node.js

• Download: nodejs.org → versão LTS (mais estável)
• Por quê: necessário para rodar ferramentas modernas de desenvolvimento, incluindo o Gemini CLI
• Instale e verifique com node -v e npm -v no terminal

3. Gemini CLI

• Com Node.js instalado, rode no terminal:

npm install -g @google/gemini-cli

• Por quê: permite usar a IA Gemini direto pelo terminal, integrado ao seu fluxo de trabalho
• Autentique com sua conta Google: gemini auth login

4. Biblioteca ifcopenshell (Python)

• Com Python instalado, rode:

pip install ifcopenshell

• Por quê: permite ler, criar e manipular arquivos IFC (formato aberto BIM) via script Python
• Verifique a instalação: python -c "import ifcopenshell; print(ifcopenshell.version)"

5. Google Apps Script + Google Planilhas

• Acesso: abra uma planilha no Google Sheets → menu Extensões → Apps Script
• Por quê: permite automatizar tarefas dentro do ecossistema Google (enviar e-mails, preencher planilhas, criar relatórios) sem instalar nada
• Não requer instalação local — roda 100% no navegador

6. Google Antigravity IDE

• Download: antigravity.google → disponível para Windows (preview gratuito)
• Por quê: IDE de nova geração do Google, focada em agentes de IA. É um fork do VS Code, então a interface já é familiar. Permite orquestrar múltiplos agentes de IA trabalhando em paralelo no seu código
• Instale como qualquer programa Windows (.exe), abra e faça login com sua conta Google
• Modelos disponíveis gratuitamente: Gemini 3.1 Pro e Claude Sonnet
• Diferencial: em vez de um chat na barra lateral, você gerencia agentes autônomos que executam tarefas completas — você age como arquiteto, eles executam

---

Básico de terminal no Windows (CMD / PowerShell)

Por quê usar o terminal? A maioria das instalações e comandos desta aula são feitos pelo terminal.

Como abrir:

• Pressione Windows + R, digite powershell e Enter
• Ou pesquise PowerShell no menu Iniciar → clique com botão direito → Executar como administrador (necessário para instalações)

Comandos essenciais:

Comando	O que faz
cd nomeDaPasta	Entra em uma pasta
cd ..	Volta uma pasta
dir	Lista arquivos na pasta atual
cls	Limpa a tela
python --version	Verifica se Python está instalado
node -v	Verifica se Node.js está instalado
pip install nome	Instala biblioteca Python
npm install -g nome	Instala ferramenta Node.js globalmente

Dicas importantes:

• Após instalar qualquer programa, feche e reabra o terminal — ele não atualiza automaticamente
• Quando aparecer erro, leia a última linha: geralmente diz exatamente o problema
• Para colar no terminal Windows: clique com o botão direito do mouse

---

Troubleshootings comuns

Python

• python não reconhecido no terminal → reinstale marcando "Add Python to PATH" ou adicione manualmente nas variáveis de ambiente do sistema
• pip não encontrado → use python -m pip install ... em vez de só pip
• Versões conflitantes → use python3 e pip3 se houver Python 2 e 3 instalados

Node.js / npm

• Erro de permissão no npm → no Windows, abra o terminal como Administrador
• node não reconhecido → reinicie o terminal após a instalação
• Versão antiga → desinstale e baixe a LTS mais recente do site oficial

Gemini CLI

• Erro de autenticação → rode gemini auth login novamente e certifique-se de usar a conta Google correta
• Comando não encontrado após instalar → feche e reabra o terminal

ifcopenshell

• Erro ao importar → verifique se instalou no Python correto (python -m pip install ifcopenshell)
• Versão incompatível com Python → use Python 3.10 ou 3.11 para maior compatibilidade

Google Apps Script

• Script não salvo → use Ctrl+S ou clique no ícone de disquete antes de rodar
• Erro de autorização → na primeira execução, o Google pede permissão; clique em "Permitir" após revisar os escopos
• Cota excedida → o Apps Script tem limites diários gratuitos; espaçe as execuções ou use conta Google Workspace

Google Antigravity

• Erro de login → tente fechar e reabrir; se persistir, aguarde alguns minutos (pode ser instabilidade do servidor Google)
• "You need to set up a workspace" → abra uma pasta local pelo menu File → Open Folder antes de usar o agente
• Extensões do VS Code não aparecem → por ser um fork, a maioria das extensões é compatível; instale normalmente pela aba Extensions

Terminal Windows (geral)

• Comando não reconhecido após instalar → feche e reabra o terminal
• Acesso negado / Permission denied → execute o PowerShell como Administrador
• Erro ao colar comando → use botão direito do mouse para colar no CMD/PowerShell